> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lokasi

> Pelajari cara menggunakan komponen Lokasi di YiDA untuk memilih alamat detail berbasis pembagian administratif, mengaktifkan positioning mobile, dan mengatur alamat default secara efisien.

## 1. Komponen Lokasi

### 1.1 Apa itu komponen Lokasi

Pemilih alamat detail berbasis pembagian administratif standar Tiongkok saat ini.

Tambah komponen Lokasi

### 1.2 Skenario penggunaan

* Komponen Lokasi kini mendukung positioning pada perangkat mobile, memungkinkan Anda mengisi informasi alamat dengan cepat sekaligus tetap dapat mengeditnya lebih lanjut.
* Jika alamat yang ingin dipilih kebetulan merupakan lokasi Anda saat ini, ketuk ikon positioning pada perangkat mobile (dengan izin lokasi diaktifkan). Informasi alamat akan terisi otomatis dan tetap dapat diedit setelahnya.
* Umum digunakan pada skenario pemilihan alamat, seperti alamat pengiriman dan alamat wilayah administratif.
* Komponen telah dilengkapi dengan data terbaru Provinsi / Kota / Distrik (Kabupaten) / Jalan (Kecamatan) Tiongkok. Cukup tambahkan komponen Lokasi untuk mulai menggunakannya.

## 2. Atribut

### 2.1 Tips placeholder

* Mirip dengan teks placeholder abu-abu dalam kotak input standar, digunakan untuk memberikan panduan.
* Jika tidak ada alamat default yang ditetapkan, tips placeholder akan ditampilkan. Jika sudah ditetapkan, konten alamat default akan ditampilkan terlebih dahulu.

### 2.2 Tipe

* Mengatur tingkat detail alamat.
* Jika Alamat detail dipilih, komponen menampilkan dua baris.
* Jika Alamat detail tidak dipilih, hanya satu baris yang ditampilkan, seperti terlihat di bawah:

Pilih tipe tampilan alamat.

### 2.3 Sub-judul dan konten prompt komponen

Pengaturan berikut berlaku untuk kotak input alamat detail setelah memilih Alamat detail, seperti terlihat di bawah:

### 2.4 Izinkan hapus

Ketika sakelar Izinkan hapus diaktifkan, Anda dapat menghapus data komponen yang telah dimasukkan dengan sekali klik saat mengirimkan formulir.

### 2.5 Alamat default untuk komponen

* Anda dapat menginisialisasi alamat default di sisi kanan designer.
* Tingkat detail nilai default akan otomatis terhubung dengan opsi yang dipilih di Tipe.

### 2.6 Positioning cepat

* Perangkat mobile mendukung positioning untuk mengisi informasi alamat dengan cepat.

#### 2.6.1 Skenario penggunaan

* Ketika alamat yang ingin dipilih kebetulan merupakan lokasi Anda saat ini.
* Ketuk ikon positioning pada perangkat mobile (dengan izin lokasi diaktifkan). Informasi alamat akan terisi otomatis dan tetap dapat diedit setelahnya.

| **Panel atribut komponen saat desain** | **Efek komponen saat runtime** |
| -------------------------------------- | ------------------------------ |
|                                        |                                |

## 3. Premium

### 3.1 Pengaturan tindakan

Untuk mengonfigurasi kode JS sebagai tindakan untuk komponen ini:

**Jalur**: Klik Buat tindakan >> Perubahan nilai >> Konfigurasikan kode JS, seperti terlihat di bawah:

Konfigurasikan kode JS.

## 4. FAQ

<AccordionGroup>
  <Accordion id="q1" title="4.1 Komponen Lokasi saat ini menampilkan nama lokasi. Adakah cara untuk memperoleh informasi bujur dan lintang?">
    YiDA saat ini belum mendukung pengambilan bujur dan lintang pada komponen Lokasi. Sebelumnya, bujur dan lintang tersedia pada komponen Positioning. Komponen Lokasi saat ini hanya menyediakan kode wilayah, dan bujur serta lintang belum dapat diperoleh.
  </Accordion>

  <Accordion id="q2" title="4.2 Apakah garis miring pada kontrol Lokasi dapat dihilangkan? Ketika data diekstrak dan digabungkan ke bidang Teks satu baris, apakah garis miring dapat dihilangkan otomatis, misalnya menggunakan JS?">
    Setelah memperoleh informasi wilayah, Anda dapat menggunakan JS untuk memproses hasilnya dan menetapkannya ke bidang Teks satu baris untuk menghilangkan tanda "/".

    ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
    // Kode referensi (terhubung ke komponen Lokasi)
    export function onChange({ value }, extra) {
      if (value.regionText) {
        let allAddress = '';
        value.regionText.map(el => {
          allAddress += el.zh_CN
        })
        allAddress += value.address
        this.$('textField_kr49k4ug').setValue(allAddress)
      }
    }
    ```
  </Accordion>
</AccordionGroup>