AztecEditor Androidダウンロード-Azteceditor AztecEditor Androidソースコードのダウンロード

AztecEditor Android

その他のリソース

v2.1.4

ダウンロード

AZTEC：AndroidのネイティブHTMLエディター

Aztec（Edittextを拡張）は、AndroidでHTMLドキュメントを作成するためのリッチテキストエディターコンポーネントです。

最小Androidサポートバージョン

build.gradle内のminSdkVersion構成を調べることにより、サポートされている最小Androidバージョンを確認できます。

ビジュアルエディター

はじめる

レイアウトの主なコンポーネントを宣言します。

ビジュアルエディター

< org .wordpress.aztec.AztecText
    android : id = " @+id/visual "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    android : scrollbars = " vertical "
    android : imeOptions = " flagNoExtractUi "
    aztec : historyEnable = " false " />

ソースエディター

< org .wordpress.aztec.source.SourceViewEditText
    android : id = " @+id/source "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    android : inputType = " textNoSuggestions|textMultiLine "
    android : scrollbars = " vertical "
    android : imeOptions = " flagNoExtractUi "
    aztec : codeBackgroundColor = " @android:color/transparent "
    aztec : codeTextColor = " @android:color/white " />

ツールバー

< org .wordpress.aztec.toolbar.AztecToolbar
    android : id = " @+id/formatting_toolbar "
    android : layout_width = " match_parent "
    android : layout_height = " @dimen/format_bar_height "
    android : layout_alignParentBottom = " true " />

ビューを膨らませる：

 val visualEditor = findViewById< AztecText >( R .id.visual)
val sourceEditor = findViewById< SourceViewEditText >( R .id.source)
val toolbar = findViewById< AztecToolbar >( R .id.formatting_toolbar)

提供された画像とビデオローダーを使用してAZTECを構成します。

 Aztec . with (visualEditor, sourceEditor, toolbar, context)
    .setImageGetter( GlideImageLoader (context))
    .setVideoThumbnailGetter( GlideVideoThumbnailLoader (context))

編集履歴、リスナー、プラグインなどのその他のオプションについては、デモアプリの実装を参照してください。

ビルドとテスト

ライブラリを構築し、プロジェクトのサンプルを構築し、ユニットテストを実行します。

$ ./gradlew build

ユニットテストのみを実行します：

$ ./gradlew test

計装テストを実行する前に

エスプレッソは、テストに使用されるデバイスでシステムアニメーションを無効にすることをアドバイスします。

デバイスでは、設定の下で - >開発者オプションは、次の3つの設定を無効にします。
ウィンドウアニメーションスケール
トランジションアニメーションスケール
アニメーターの持続時間スケール

クリック時にエスプレッソの問題を処理するには、追加のセットアップステップも必要です（以下の警告を参照）：

デバイスでは、設定の下で - >アクセシビリティ - >タッチアンドホールド遅延、遅延をLong設定します。

計装テストを実行します：

$ ./gradlew cAT

プロジェクトにアステカを統合します

 repositories {
    maven { url " https://a8c-libs.s3.amazonaws.com/android " }
}

 dependencies {
    api " org.wordpress:aztec:v1.6.2 "
}

勇敢な開発者は、プロジェクトをソース分布として使用するか、自分の責任で最新のスナップショットを楽しむことができます。

 dependencies {
    api " org.wordpress:aztec:trunk-{commit_sha1} "
    // As an example, for '3f004c8c8cd4b53ab9748f42f373cf00a30e9d86' commit sha1, this would look like:
    // api "org.wordpress:aztec:trunk-3f004c8c8cd4b53ab9748f42f373cf00a30e9d86"
}

変更

APIを使用して、AZTECの動作を変更できます。

ツールバーアイテム

AZTECライブラリが提供する機能を制限する場合は、 AztecToolbarのsetToolbarItemsメソッドを呼び出すことができます。次の例では、指定された順序でbold pluginsとlistアイテムのみを有効にします。

aztecToolbar.setToolbarItems( ToolbarItems . BasicLayout ( ToolbarAction . BOLD , ToolbarItems . PLUGINS , ToolbarAction . LIST ))

デフォルトでは有効になっていない新しいアイテムを設定できます。 ToolbarAction.CODE and ToolbarAction.PRE 。

CODEインラインHTMLコードを表します
PREプリフォーマットブロック（コードブロックを含む）を表します

タスクリスト

エディターで有効にできるオプションのリストタイプがあります。注文されていないリストに加えて、 task listを使用できます。タスクリストは、弾丸の代わりにチェックボックスを表示および保存する順序付けられていないリストです。次の方法を呼び出して有効にします。

aztecToolbar.enableTaskList()

ネストされたブロック

デフォルトでは、AZTECを使用すると、ネストされたブロックが許可されます。特定の場合、これは好ましい動作である必要はありません。ネストされたブロックを無効にするオプションがあります。切り替えた場合、このエディターは、現在選択されているブロックの後ではなく、現在選択されているブロックの後に常にメディアと水平ルールを追加します。

aztecText.addMediaAfterBlocks()

プレースホルダーAPI

Aztecは現在、プレースホルダーをサポートして、Edittextとスパン可能なAPIによってネイティブにサポートされていないビューを描画します。この機能は、ビジュアルエディターにスパンを作成し、その上にAndroidビューを描画します。ユーザーがエディターに何かを変更し、エディターでインラインで再生できるビデオのようなものを描くことができると、ビューは動き回られます。 APIを使用するには、 PlaceholderManagerのインスタンスを作成し、このようなonCreateコールで初期化する必要があります。

 private lateinit var placeholderManager : PlaceholderManager
override fun onCreate ( savedInstanceState : Bundle ? ) {
    placeholderManager = PlaceholderManager (visualEditor, findViewById( R .id.container_frame_layout))
    aztec.addPlugin(placeholderManager)
    aztec.addOnMediaDeletedListener(placeholderManager)
}
override fun onDestroy () {
    placeholderManager.onDestroy()
}

カスタムプレースPlaceholderAdapterを作成して、ビューを準備して描画できます。画像とキャプションでシンプルなAndroidビューを描くサンプルImageWithCaptionAdapter確認できます。ただし、再生コントロールを使用して、 YouTubeビューやVideoビューなどを実装できます。このようにPlaceholderAdapterを登録することを忘れないでください：

placeholderManager.registerAdapter( ImageWithCaptionAdapter ())

マネージャーとアダプターの両方を初期化したら、マネージャーメソッドを使用してプレースホルダーを挿入または削除できます。

placeholderManager.insertItem(adapterType, attributes)
placeholderManager.removeItem(predicate)

コードフォーマット

KtlintをKotlin Lintingに使用します。 ./gradlew ktlintを使用してktlintを実行できます。また、自動フォーマットのために./gradlew ktlintFormat実行することもできます。現時点では、アイデアプラグイン（CheckStyleのような）はありません。