Di Objective C, saya dapat menggunakan #pragma markuntuk menandai bagian dari kode saya di navigator simbol. Karena ini adalah perintah preprocessor C, itu tidak tersedia di Swift. Apakah ada alasan untuk ini di Swift, atau apakah saya harus menggunakan komentar jelek?

Kamu bisa menggunakan // MARK:

Ada juga diskusi bahwa penggunaan liberal ekstensi kelas mungkin merupakan praktik yang lebih baik. Karena ekstensi dapat mengimplementasikan protokol, misalnya Anda dapat meletakkan semua metode delegasi tampilan tabel dalam ekstensi dan mengelompokkan kode Anda pada tingkat yang lebih semantik daripada #pragma markyang mampu dilakukan.

Hingga Xcode 5 arahan preprosesor #pragma markada.

Dari Xcode 6 aktif, Anda harus menggunakan // MARK:

Fitur-fitur preprocessor ini memungkinkan untuk membawa beberapa struktur ke kotak drop down fungsi editor kode sumber.

beberapa contoh :

// MARK:

-> akan didahului oleh pembagi horizontal

// MARK: your text goes here

-> menempatkan 'teks Anda masuk ke sini' dalam huruf tebal di daftar drop down

// MARK: - your text goes here

-> menempatkan 'teks Anda masuk ke sini' dicetak tebal dalam daftar drop-down, didahului oleh pembagi horizontal

perbarui: menambahkan tangkapan layar karena beberapa orang tampaknya masih memiliki masalah dengan ini:

Bagi mereka yang tertarik menggunakan ekstensi vs tanda pragma (seperti yang disebutkan dalam komentar pertama), berikut adalah cara menerapkannya dari Insinyur Swift:

import UIKit

class SwiftTableViewController: UITableViewController {

    init(coder aDecoder: NSCoder!) {
        super.init(coder: aDecoder)

    }

    override func viewDidLoad() {
        super.viewDidLoad()

    }
}

extension SwiftTableViewController {
    override func numberOfSectionsInTableView(tableView: UITableView?) -> Int {
        return 1
    }

    override func tableView(tableView: UITableView?, numberOfRowsInSection section: Int) -> Int {
        return 5
    }

    override func tableView(tableView: UITableView?, cellForRowAtIndexPath indexPath: NSIndexPath?) -> UITableViewCell? {
        let cell = tableView?.dequeueReusableCellWithIdentifier("myCell", forIndexPath: indexPath) as UITableViewCell;

        cell.textLabel.text = "Hello World"

        return cell
    }

}

Ini juga belum tentu praktik terbaik, tetapi ini adalah bagaimana Anda melakukannya jika Anda mau.

Pragma mark - [SOME TEXT HERE]digunakan dalam Objective-C untuk mengelompokkan beberapa fungsi bersama dengan memisahkan garis.

Di Swift Anda dapat mencapai ini dengan menggunakanMARK, TODO OR FIXME

saya. MARK: //MARK: viewDidLoad

Ini akan membuat garis horizontal dengan fungsi yang dikelompokkan di bawah viewDidLoad (ditunjukkan pada tangkapan layar 1)

ii. MELAKUKAN : //TODO: - viewDidLoad

Ini akan mengelompokkan fungsi di bawah TODO: - Kategori viewDidLoad (ditunjukkan pada tangkapan layar 2)

aku aku aku. PERBAIKI AKU : //FIXME - viewDidLoad

Ini akan mengelompokkan fungsi di bawah FIXME: - kategori viewDidLoad (ditunjukkan pada tangkapan layar 3)

Periksa dokumentasi apel ini untuk detailnya.

Dokumentasi Resmi

Dokumen resmi Apple tentang Bilah Lompat Xcode: Tambahkan anotasi kode ke bilah lompat

Jump Bar Screenshot untuk Contoh Kode

Perilaku dalam Xcode 10.1 dan macOS 10.14.3 (Mojave)

Perilaku dalam Xcode 10.0 dan macOS 10.13.4 (High Sierra)

Perilaku dalam Xcode 9.4.1 dan macOS 10.13.0

Diskusi

!!!:dan ???:terkadang tidak dapat ditampilkan.

Dalam kode Objective-C Xcode mendeteksi komentar seperti // MARK: - fooyang sedikit lebih portabel daripada #pragma. Tapi ini sepertinya tidak diambil juga (belum?).

Sunting: Diperbaiki dalam Xcode 6 beta 4.

Saya pikir Extensionsitu cara yang lebih baik #pragma mark.

Kode sebelum menggunakan Extensions:

class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate {
    ...

    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
        ...
    }
}

Kode setelah menggunakan Extensions:

class ViewController: UIViewController {
    ...
}

extension ViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }
}

extension ViewController: UICollectionViewDelegate {
    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
       ...
    }
}

Xcode 8 sekarang menanganinya sebagai diikuti dan muncul seperti ini di dropdown metode:

Dikonfirmasi dengan Apple Engineer di lab Swift pagi ini di WWDC bahwa saat ini tidak ada #pragma atau yang setara, mereka menganggap ini bug, dan akan segera tiba, jadi saya menduga beta 2, saya harap.

Pokoknya, ini jalannya.

Xcode sekarang mendukung // MARK :, // TODO: dan // landmark FIXME untuk membubuhi keterangan kode Anda dan mencantumkannya di bilah lompat

Ada Tiga opsi untuk ditambahkan #pragma_markdi Swift:

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Catatan: Penggunaan -untuk menambahkan pemisah

Menggunakan

// MARK: SectionName

atau

// MARK: - SectionName

Ini akan memberikan garis di atas tanda pragma, membuatnya lebih mudah dibaca.

Untuk memudahkan, tambahkan saja

// MARK: - <#label#>

ke cuplikan kode Anda.

Cara alternatif -

Gunakan dengan cara ini

private typealias SectionName = ViewController
private extension SectionName  {
    // Your methods
}

Ini tidak hanya akan menambah tanda (seperti tanda pragma) tetapi juga memisahkan kode dengan baik.

//# MARK: - Spinner Class Methods

Tambahkan garis antara titik dua dan deskripsi Anda untuk menyisipkan garis pemisah. Ini membantu mengatur lebih banyak kode Anda. Kode dan tangkapan layar di atas memanfaatkan komentar MARK dengan garis yang disertakan.

1. // # MARK: - Metode Teks (LINE)
2. // # MARK: Metode Teks (TANPA LINE)

Ini hanya berfungsi dengan komentar MARK.

Anda juga mungkin tertarik dengan arahan kompiler Swift 4.2 / XCode 10 suka

#warning("Some string to display")

dan

#error("Some error to display")

Ini mungkin berguna ketika Anda benar-benar tidak ingin ketinggalan sesuatu.

Pemrogram profesional harus menggunakan tag ini untuk kode yang baik. Ini juga bagus untuk kerja tim.

// MARK: example Web Service start here
// TODO: example 1
// FIXME: Please change BASE url before live 

Sangat mudah untuk menemukan metode seperti ini

Dalam Xcode 11 mereka menambahkan minimap yang dapat diaktifkan Editor -> Minimap.

Minimap akan menampilkan setiap teks tanda untuk orientasi cepat dalam kode. Setiap tanda ditulis seperti// MARK: Variables

//MARK:tidak tampak bekerja untuk saya di Xcode 6.3.2. Namun, inilah yang saya lakukan untuk membuatnya bekerja :

1) Kode:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) Dalam jump barapa - apa tampaknya tidak berubah ketika menambahkan //MARK: komentar. Namun, jika saya mengklik nama paling kanan di bilah lompat, dalam kasus saya dikatakan MainWindowController(with a leading C icon), maka jendela sembulan akan menampilkan yang menunjukkan efek dari // MARK: komentar, yaitu tajuk yang mengatakan "Metode keren saya":

3) Saya juga memperhatikan bahwa jika saya mengklik salah satu metode dalam kode saya, maka metode tersebut menjadi entri paling kanan di bilah lompat. Untuk bisa MainWindowController(with a leading C icon)menjadi entri paling kanan di panel lompat, saya harus mengklik spasi putih di atas metode saya.

Apple menyatakan dalam versi terbaru dari Building Cocoa Apps ,

Kompiler Swift tidak termasuk preprosesor. Alih-alih, itu mengambil keuntungan dari atribut waktu kompilasi, membangun konfigurasi, dan fitur bahasa untuk mencapai fungsi yang sama. Karena alasan ini, arahan preprosesor tidak diimpor dalam Swift.

Karakter # tampaknya masih menjadi cara Anda bekerja dengan berbagai konfigurasi bangunan dan hal-hal seperti itu, tetapi sepertinya mereka berusaha mengurangi kebutuhan Anda akan sebagian besar pemrosesan awal dalam nada pragma dan meneruskan Anda ke fitur bahasa lainnya secara bersamaan. Mungkin ini untuk membantu pengoperasian Playgrounds dan REPL berperilaku sedekat mungkin dengan kode yang sepenuhnya dikompilasi.

Tambahkan item yang harus dilakukan: Masukkan komentar dengan awalan TODO :. Misalnya: // TODO: [item agenda Anda].

Tambahkan pengingat perbaikan bug: Masukkan komentar dengan awalan FIXME :. Misalnya: // FIXME: [pengingat perbaikan bug Anda].

Tambahkan judul: Masukkan komentar dengan awalan MARK :. Misalnya: // MARK: [heading bagian Anda].

Tambahkan garis pemisah: Untuk menambahkan pemisah di atas anotasi, tambahkan tanda hubung (-) sebelum bagian komentar dari anotasi. Misalnya: // MARK: - [konten Anda]. Untuk menambahkan pemisah di bawah anotasi, tambahkan tanda hubung (-) setelah bagian komentar dari anotasi. Misalnya: // MARK: [konten Anda] -.

Coba ini:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

Tanda Pragma adalah cara untuk meningkatkan keterbacaan kode Anda. Komentar pragma akan muncul seperti tag pada jumpbar Xcode.

//MARK:  <Your comment goes here>

Contoh: Dalam kode,

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

Beginilah tampilannya di bilah lompat Xcode.