Guides and Sample Code

Developer

Playground Book Format Reference

AssessmentStatus Enumeration
AssessmentStatus列挙

An enumeration used for getting and setting the current assessment state of a playground page and providing optional feedback to the user.
ある列挙で、プレイグラウンドページの現在の評価状態の取得や設定をすることおよびユーザに対する随意のフィードバックの提供することのために使われます。

Enumeration Cases
Enumerationケース節

fail

Indicates that the user failed the task for the playground page and provides updated hints.
ユーザがプレイグラウンドページの課題を失敗したことを指し示します、そして更新されたヒントを提供します。

Declaration
宣言

  1. case fail(hints: [String], solution: String?)

Associated values
関連値

  • hints: A new array of hints for the Hint button. Any existing hints are replaced.
    hints: Hintボタンのための新しいヒントの配列。あらゆる既存のヒントは置き換えられます。

  • solution: An optional solution string. The content is added as a hint that is hidden by a Show Solution button.
    solution: 任意の解答文字列。内容はヒントの1つとして加えられます、それはShow Solutionボタンによって隠されます。

Discussion
解説

To provide just a solution, leave the hints array empty. If no solution is provided, there must be at least one string in the hints array.
ただ解答だけを提供するには、hints配列を空のままにしてください。解答が提供されないならば、少なくとも1つの文字列がhints配列の中になければなりません。

The following example sets one hint for the page. The markup in the hint string displays the word “for” in code voice.
以下の例は、1つのヒントをページに設定します。ヒント文字列の中のマークアップは、単語「for」をコード調で表示します。

The strings for the solution and for hints can contain markup. For more information on markup, see Markup Formatting Reference.
解答およびヒントの文字列は、マークアップを含むことができます。マークアップに関するさらなる情報として、Markup Formatting Referenceを見てください。

  1. import PlaygroundSupport
  2. PlaygroundPage.current.assessmentStatus = .fail(hints: ["Try using a `for` loop"], solution: nil)

pass

Indicates that the user succeeded at the task for the playground page and provides a success message.
ユーザがプレイグラウンドページの課題に成功したことを指し示して、合格メッセージを提供します。

Declaration
宣言

  1. case pass(message: String?)

Associated values
関連値

  • message: A message displayed in the Hints area. The area is expanded to display the message. The Hint button is replaced by a completion button.
    message: Hint領域で表示されるメッセージ。この領域は、メッセージを表示するために広げられます。Hintボタンは、完了ボタンによって置き換えられます。

The following example shows a popover with the message “Great job!” The message string uses markup to display the word “Great” using bold font.
以下の例は、メッセージ「Great job!」をもつポップオーバーを表示します。メッセージ文字列はマークアップを使用して、単語「Great」を太字フォントを使って表示します。

The message argument can contain markup. For more information on markup, see Markup Formatting Reference.
メッセージ引数は、マークアップを含むことができます。マークアップに関するさらなる情報として、Markup Formatting Referenceを見てください。

  1. import PlaygroundSupport
  2. PlaygroundPage.current.assessmentStatus = .pass(message: "**Great** job!")