[Android][Java] 내가 원하는 위치에 도움말(ToolTip) 보여주기

안녕하세요!

이번 시간에는 원하는 위치에 ToolTip을 띄워 보여주는 기능을 만들어 보겠습니다!

 

먼저 gradle에 라이브러리를 등록해줍니다.

 

build.gradle(Module:프로젝트명:app)
dependencies 괄호 안에 아래 코드를 넣어주세요.

implementation 'com.tomergoldst.android:tooltips:1.1.1'

 

다음으로 xml 파일입니다.

activity_tooltip.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/main_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <TextView
        android:id="@+id/text_view"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_alignParentTop="true"
        android:layout_centerInParent="true"
        android:layout_marginTop="50dp"
        android:background="@color/purple_200"
        android:gravity="center"
        android:text="View"
        android:textColor="@color/white" />

    <RadioGroup
        android:id="@+id/position_radio"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/text_view"
        android:layout_marginTop="80dp"
        android:orientation="horizontal">

        <RadioButton
            android:id="@+id/above_rb"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="15dp"
            android:checked="true"
            android:text="위" />

        <RadioButton
            android:id="@+id/right_rb"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="15dp"
            android:text="오른쪽" />

        <RadioButton
            android:id="@+id/left_rb"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="15dp"
            android:text="왼쪽" />

        <RadioButton
            android:id="@+id/below_rb"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="15dp"
            android:text="아래" />
    </RadioGroup>

    <EditText
        android:id="@+id/message_edit_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/position_radio"
        android:layout_marginTop="50dp"
        android:padding="12dp" />
</RelativeLayout>

 

다음으로 자바 파일입니다.

CircelDialogActivity.java

public class ToolTipActivity extends AppCompatActivity implements ToolTipsManager.TipListener {

    RelativeLayout mainLayout;

    EditText messageEditText;

    TextView textView;

    ToolTipsManager toolTipsManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_tooltip);

        mainLayout = findViewById(R.id.main_layout);

        messageEditText = findViewById(R.id.message_edit_text);

        textView = findViewById(R.id.text_view);

        toolTipsManager = new ToolTipsManager(this);

        //텍스트뷰 클릭 시 이벤트
        textView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                toolTipsManager.dismissAll(); //툴팁 해제
            }
        });


        RadioGroup positionRadio = findViewById(R.id.position_radio);

        //라디오버튼 체크 변화시에 이벤트
        positionRadio.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
            @Override
            public void onCheckedChanged(RadioGroup radioGroup, int checkId) {

                switch (checkId) {
                    case R.id.above_rb: //위
                        displayTooltip(ToolTip.POSITION_ABOVE, ToolTip.ALIGN_RIGHT);
                        break;
                    case R.id.right_rb: //오른쪽
                        displayTooltip(ToolTip.POSITION_RIGHT_TO, ToolTip.ALIGN_CENTER);
                        break;
                    case R.id.left_rb: //왼쪽
                        displayTooltip(ToolTip.POSITION_LEFT_TO, ToolTip.ALIGN_CENTER);
                        break;
                    case R.id.below_rb: //아래
                        displayTooltip(ToolTip.POSITION_BELOW, ToolTip.ALIGN_LEFT);
                        break;
                }
            }
        });
    }

    //툴립 해제될 때 실행됨
    @Override
    public void onTipDismissed(View view, int anchorViewId, boolean byUser) {

        if (byUser) {
            Toast.makeText(getApplicationContext(), "해제", Toast.LENGTH_SHORT).show();
        }
    }

    /**
     * 툴팁 설정
     *
     * @param position 위치
     * @param align    맞출 위치
     */
    private void displayTooltip(int position, int align) {

        //변수에 메시지를 담는다.
        String message = messageEditText.getText().toString().trim();

        toolTipsManager.findAndDismiss(textView); //툴팁 해제

        //메시지가 있다면
        if (!message.isEmpty()) {

            ToolTip.Builder builder = new ToolTip.Builder(this,
                    textView, mainLayout, message, position);

            builder.setAlign(align);

            builder.setBackgroundColor(Color.BLUE);

            builder.setGravity(ToolTip.GRAVITY_RIGHT);

            toolTipsManager.show(builder.build());

        } else { //없다면
            Toast.makeText(getApplicationContext(), "메시지가 없습니다.", Toast.LENGTH_SHORT).show();
        }
    }
} //ToolTipActivity

 

실행화면 입니다.

 

메세지를 입력 후, 라디오 버튼을 통해 원하는 위치에 툴팁을 띄울 수 있습니다.

오늘 준비한 내용은 여기까지 입니다.

궁금한 내용은 언제든 댓글로 질문해주세요!

감사합니다!